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Agenda 


e Why? 
e What is an “effect” anyway? 
e nvFX 


e Is nvFS useful? 


Why? 


Why? 


uniform mat4x2 arg0; 
uniform mat4x2 argl; 
uniform float tolerance; 
uniform mat4x2 expected; 


void main() 


í 


mat4x2 result = matrixCompMult(arg0, argl); 

mat4x2 residual = result - expected; 

float error sq = residual[0][0] * residual[0][0] + residual[0][1] 
* residual[0][1] + residual[1][0] * residual[1][0] + residual[1][1] 
* residual[1][1] + residual[2][0] * residual[2][0] + residual[2][1] 
* residual[2][1] + residual[3][0] * residual[3][0] + residual[3][1] 
* residual[3][1]; 

gl FragColor = error sq <= tolerance * tolerance 
2 vec4(0.0, 1.0, 0.0, 1.0) : vec4(1.0, 0.0, 0.0, 1.0); 


Why? 


#version 130 

in vec3 normal es, position es; 

out vec4 color; 

uniform vec3 light_es = vec3(0.0, 15.0, 4.0); 
uniform float m = 0.2; 

uniform float ri = 1.5; 
uniform vec3 color_s vec3(1.0); 

uniform vec3 color d = vec3(1.0, 0.0, 0.0); 


low 


float schlick(float ni, float cos theta) 
{ 
float c = 1.0 - cos_theta; 
float r0 = (ni - 1.0) / (ni + 1.0); 
r0 = r0 * r0; 
return r0 + (1.0 - r0) * pow(c, 5.0); 


} 


float G(float n dot 1, float n dot h, 
float n_ dot v, float v dot _h) 


{ 
float c = 2.0 * n dot. h./ v dot b; 
return min(1.0, c * min(n dot v, 
n dot l)); 
} 


} 


beckmann(float m, float cos theta) 


float c2 = cos theta * cos theta; 

m = max(m, le-6); 

float m c2 = m * c2; 

return exp((c2 - 1.0) / (m * m c2)) 
/ (4.0 * m c2 * m c2); 


void main(void) 


{ 


vec3 1 = normalize(light es - position es); 
vec3 v = -normalize(position es); 
vec3 n = normalize(normal es); 
vec3 h = normalize(l + v); 

float ndl = dot(n, 1); 

float ndh = dot(n, h); 

float ndv dot(n, v); 


float f = schlick(ri, ndv) * beckmann(m, ndh) 
* G(ndl, ndh, ndv, dot(v, h)) / ndv; 


vec3 spec 
vec3 diff 


f * color s; 
color d * max(ndl, 0.); 


color = vec4((spec + diff), 1.0); 


Why? 


e shader runner is piglit's mechanism for testing shaders 
e Really hard to draw anything other than a rectangle 
e Really hard to get additional per-vertex data to the shader 
e Really hard to use a non-trival texture 
e You can use any texture you want, as long as you only want checkerboard or RGBW 
e Really hard to set other GL state 
e Difficult to extend 
° The parser... gives me nightmares. 
e etc. 


Why? 


e Holy grail: Easily import shaders from real apps 
e shader_runner doesn't really help here 
e There are a couple shader tests like this 
e apitrace could help 
e Trace files tend to be quite large 
e Trace files are difficult to tweak 
e Want to modify a GL 3.3 test to run on GL ES 3.0 
e Trace files are difficult to create from scratch 
e Write an application, then trace it 


What is an effect? 


e High-level encapsulation of a drawing method 
e Shader code 
e Uniform values 
e GL state settings 
e Samplers, textures, etc. 
e Rasterization settings 


e An effect may contain multiple passes 
° Set one shader & parameters, draw, repeat... 


What is nvFX? 


e An effects file format created by Tristan Lorch (NVIDIA) 
° Inspired by cgFX, but not specific to cg 
e Open-source library 
° https://github.com/tlorach/nvFX 


e See also: 


https://developer.nvidia.com/sites/default/files/akamai/gamedev/docs/nvFX%20A%20New%20Shader-Effect%20Framework.pdf 


e Search “nvfx site:developer.nvidia.com” 


https:/Awww.khronos.org/assets/uploads/developers/library/2013-siggraph-opengl-bof/nvFX-effects-framework-OpenGL-BOF_SIGGRAPH-2013. pdf 


e Search “nvfx site:khronos.org” 


nvFX Layout 


GLSLShader {// Prepend to all shaders 
#version 130 
uniform mat4 mvp; 
} 
GLSShader ObjectVvs { 
in vec4 position; 
in vec3 normal; 
out vec3 normal eye space; 
void main() { 


} 


} 
GLSLShader ObjectFS { 


} 
GLSLShader DiffuseFromTexture { 


uniform sampler2D tex; 
vec4 getDiffuse(vec3 tc) { 
return texture( tex, tc); 


SamplerState defaultSampState { 
TEXTURE MIN FILTER = 
LINEAR MIPMAP LINEAR; 
TEXTURE MAG FILTER = LINEAR; 


} 
TextureResource2D diffuseTexture < 
defaultFile = "image.ktx"; 
> { 
SamplerState = defaultSampState; 
} 


Technique TECH Diffuse { 
Pass p0 { 
VertexProgram = ObjectVS; 
FragmentProgram = { ObjectFS, 
DiffuseFromTexture }; 
SamplerResource(tex) = 
diffuseTexture; 


nvFX Layout 


namespace floor { Technique TECH Floor { 
GLShader VS { Pass p0 { 
VertexProgram = floor::VS; 
} FragmentProgram = floor::FS; 
} 
} } 


Mixed Versions 


GLSLShader common gl { 
#version 130 


} 
GLSLShader common_gles { 


#version 300 es 


} 


GLSLShader foo { 


// C++ code has to read the 


// annotation and do something smart 


// with it. 
Technique TECH gl < 
GLSL min version = 1.30 


7 À 


VertexProgram = { common gl, 


foo }; 


} 
Technique TECH gles < 


GLSL min_version = 3.00 


>q 


VertexProgram = { common gles, 


foo }; 


nvFX Advantages 


e More robust language for combining shaders into programs 

e More robust language for changing GL state 

e Much better mechanism for associating data with vertex attributes 
e Multiple passes 


e Non-screen render targets 
° So that effects can render shadow maps, etc. 


e Shaders targeting multiple shading languages can live in one place 
e Sharing shader text across versions is clunky 


e Documentation :) 


nvFX Disadvantages 


e Still requires a lot of C++ code to use 


e No direct integration with models 


e Model files would generally reference effects (by name) that are defined in 
the fx files 
e Sort of the opposite binding order from what we want 


e No transform feedback support 
e No direct way to verify results of rendered image 


e No way to specify effect requirements 
e Like “GLSL >= 1.30”in shader runner 
e Annotations may fill this gap 


e No Linux or Mac build targets yet 
e It uses cmake, so it shouldn't be too hard to add... 


Can piglit use nvFX? 


e Probably not as-is 
e Not straightforward to replace tests that draw many quads & probe results 
e No obvious way to supply additional vertex data 
° Standard set of model files? 
e We'd probably have to extend their parser 


° If apitrace could generate nvFX files... 


Can shader runner borrow ideas from nvFX? 


e Nice file format 

e Decent parser, too 

e Clean syntax for textures and state information 
[require] 


GL >= 3.0 


[fx] 


[test] 

technique foo 

draw rect -1 -1 1 1 
probe rgb 10 10 0 1 0 


e May provide an eventual migration path to nvFX 
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